home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / programmmanager / launchpadv41 / wbstart.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  8KB  |  150 lines
  1. @database "WBStart-handler"
  2. @node "Main" ""
  3. @toc "Main"
  4. Documentation for WBStart V1.3                                      27-Jun-1993
  5. Disclaimer
  6. ----------
  7.    Permission is granted to make and distribute verbatim copies of this
  8. manual provided the copyright notice and this permission notice are
  9. preserved on all copies.
  10. COPYRIGHT
  11.    Copyright (C) 1991-93 Stefan Becker
  12.    No program, document, data file or source code from this software
  13. package, neither in whole nor in part, may be included or used in other
  14. software packages unless it is authorized by a written permission from the
  15. author.
  16. NO WARRANTY
  17.    There is no warranty for this software package. Although the author has
  18. tried to prevent errors, he can't guarantee that the software package
  19. described in this document is 100% reliable. You are therefore using this
  20. material at your own risk. The author cannot be made responsible for any
  21. damage which is caused by using this software package.
  22. DISTRIBUTION
  23.    This software package is freely distributable. It may be put on any
  24. media which is used for the distribution of free software, like Public
  25. Domain disk collections, CDROMs, FTP servers or bulletin board systems.
  26.    In order to ensure the integrity of this software package, distributors
  27. should use the original archive file WBStart1_3.lha. The author cannot be
  28. made responsible if this software package has become unusable due to
  29. modifications of the archive contents or of the archive file itself.
  30.    There is no limit on the costs of the distribution, e.g. for the media,
  31. like floppy disks, streamer tapes or compact disks, or the process of
  32. duplicating. Such limits have been proven to be harmful to the idea of
  33. freely distributable software, e.g. instead of reducing the price of the
  34. floppy disk below the limit, the software was simply removed from the
  35. master disk.
  36.    Although the author does not impose any limit on the distribution of
  37. this software package, he would like to express his personal opinions on
  38. this matter:
  39.    * This software package should be made available to everyone free of
  40.      charge whenever it is possible.
  41.    * If you have acquired this software package under normal conditions from
  42.      a Public Domain dealer on a floppy disk at a price higher than 5DM or
  43.      US $5, then you have definitely paid too much. Please don't support
  44.      this improper profit making any longer and switch to a cheaper source
  45.      as soon as possible.
  46. USAGE RESTRICTIONS
  47.    No program, document, data file or source code from this software
  48. package, neither in whole nor in part, may be used on any machine which is
  49.    * for the research, development, construction, testing or production of
  50.      weapons or other military applications. This also includes any machine
  51.      which is used in the education for any of the above mentioned
  52.      purposes.
  53.    * by people who accept, support or use violence against other people,
  54.      e.g. citizens from foreign countries.
  55. SPECIAL NOTE
  56.    Support Fred Fish and his AmigaLibDisk collection! If you have some
  57. money to spare then please set up a subscription of his disks or donate it
  58. to him directly. If he has to close down, we will loose our main source for
  59. freely distributable Amiga software.
  60. What is the purpose of this program?
  61. ------------------------------------
  62.  WBStart is a package to emulate the Workbench startup procedure. Emulating
  63.  this method is easy, because you only have to load a program, create a process
  64.  for it and then send a WB startup message to it. The only problem is this
  65.  startup message, because it contains memory and directory locks owned by your
  66.  process and it is only returned after the WB process ends. So you can't leave
  67.  your program until ALL WB processes you created have ended, or the replied
  68.  messages will go into nowhere land.
  69.  WBStart solves this problem by using a handler process, which handles the
  70.  creation of the processes and then waits for the reply messages. You just send
  71.  a message to the handler port, which contains all needed information, like
  72.  name and parameters. The handler duplicates this information, so you can free
  73.  your copy and leave your program.
  74. Installation & Usage
  75. --------------------
  76.  Just copy the file WBStart-Handler into your L: directory. Be sure to set the
  77.  execute flag on this file with
  78.    Protect L:WBStart-Handler +e
  79.  You can break WBStart-Handler by sending a CTRL-C to its process. If all WB
  80.  processes have returned, it will exit.
  81.  WBStarter is an example program how to use the handler. It has the following
  82.  syntax:
  83.    WBStarter <command> [<command> ...]
  84.  WBStarter tries to start every command as WB process without parameters. If
  85.  the handler is not running, WBStarter tries to start it.
  86. How to use WBStart-Handler from your programs
  87. ---------------------------------------------
  88.  The handler opens a public message port named "WBStart-Handler Port". You must
  89.  send a message of the following type to this port:
  90.    struct WBStartMsg {
  91.                       struct Message  wbsm_Msg;
  92.                       char           *wbsm_Name;
  93.                       BPTR            wbsm_DirLock;
  94.                       ULONG           wbsm_Stack;
  95.                       LONG            wbsm_Prio;
  96.                       ULONG           wbsm_NumArgs;
  97.                       struct WBArg   *wbsm_ArgList;
  98.                      };
  99.    wbsm_Msg
  100.     Standard message structure. You MUST initialize the mn_ReplyPort field to
  101.     your own message port.
  102.    wbsm_Name
  103.     Pointer to a string, which contains the name of the program. The handler
  104.     recognizes project icons and extracts the default tool.
  105.    wbsm_DirLock
  106.     Lock on a directory. wbsm_Name will be used relative to this directory.
  107.    wbsm_Stack
  108.     Stack size for the new process. Minimum is 4096 Bytes. If a tool icon
  109.     exists, then the stack size from the icon is used. When this message is
  110.     replied, this field contains a boolean, which indicates the success of the
  111.     action.
  112.    wbsm_Prio
  113.     Priority of the new process. Must be in the range -128..127.
  114.    wbsm_NumArgs
  115.     Number of arguments in wbsm_ArgList. May be 0.
  116.    wbsm_ArgList
  117.     Pointer to an array of WB Arguments. These arguments contain lock on a
  118.     directory  and a pointer to a file name, which is relative to the
  119.     directory. Look into <workbench/startup.h> for the definition of this data
  120.     structure.
  121.  Look into the C source for WBStarter for the details.
  122. Compilation
  123. -----------
  124. This program was compiled with DICE, Matt Dillon's superb C compiler. Just
  125. say "DMake" and it will produce the binary.
  126. History
  127. -------
  128. 1.3 (27.06.1993)
  129.    - The handler now copies the path from the WB process. This solves the
  130.      problems with programs which use WB2CLI() or similiar functions to get
  131.      the WB path list, e.g. SYS:System/CLI.
  132.      My apologies to Michael Sinz, Michael B. Smith and the GRn beta testers.
  133.    - The handler now scans the path list when it tries to load a program.
  134.    - The handler now uses NewLoadSeg() instead of LoadSeg().
  135.    - Major source cleanup.
  136. 1.2 (21.09.1992)
  137.    - corrected version strings
  138. 1.1 (13.09.1992)
  139.    - Fixes weird return bug in WBStart
  140.    - Fixes "Insert volume PROGDIR:..." bug
  141. 1.0 (24.11.1991)
  142.    - Initial release
  143. Contact addresses
  144. -----------------
  145.  Send comments, suggestions or bug reports to:
  146.    Snail : Stefan Becker, Holsteinstrasse 9, 52068 Aachen, GERMANY
  147.    EMail : stefanb@pool.informatik.rwth-aachen.de
  148.            stefanb@yello.adsp.sub.org
  149. @endnode
  150.